PATH 
Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference

     

ATSUGetFontVariationNameCode

Obtains information about the name code of a font variation in a font.

OSStatus ATSUGetFontVariationNameCode (
                     ATSUFontID iFont,
                     ATSUFontVariationAxis iAxis,
                     FontNameCode *oNameCode);
iFont
A value of type ATSUFontID. Pass the ID of the font whose variation you want to get name information for.

iAxis
A value of type ATSUFontVariationAxis. Pass a valid variation whose name code you want to obtain.

oNameCode
A pointer to a value of type FontNameCode. On return, the type of the font variation name. See Font Name Code Constants for a description of possible values. You cannot pass NULL for this parameter.

function result
A result code. The result code kATSUInvalidFontErr indicates that the ID does not correspond to any installed font. The result code kATSUNotSetErr indicates that the font has no name in its name table for the indicated font variation. For a list of other ATSUI-specific result codes, see Result Codes.
DISCUSSION
The ATSUGetIndFontVariation function obtains the name code of the specified font variation. You can pass this value to the function ATSUFindFontName to find the localized font variation name identified by this name code.

VERSION NOTES
Available beginning with ATSUI 1.0.


© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)